VintaSoft Imaging .NET SDK 14.0: Документация для .NET разработчика
Vintasoft.Imaging Namespace / VintasoftImage Class / Save Methods / Save(Stream,EncoderBase,EventHandler<ProgressEventArgs>) Method
Синтаксис Exceptions Ремарки Example Требования Смотрите также
В этом разделе
    Save(Stream,EncoderBase,EventHandler<ProgressEventArgs>) Метод (VintasoftImage)
    В этом разделе
    Сохраняет этот объект VintasoftImage в указанном потоке с использованием указанного кодировщика.
    Синтаксис
    'Declaration
    
    Public Overloads Sub Save( _
    ByVal stream
    Поток, в котором должно быть сохранено изображение.
    As System.IO.Stream, _
    ByVal encoder
    Кодировщик для сохранения изображения.
    As Vintasoft.Imaging.Codecs.Encoders.EncoderBase, _
    ByVal savingProgress
    Делегат процесса сохранения изображения. Может быть установлен в null (Nothing в Visual Basic).
    As System.EventHandler(Of ProgressEventArgs) _
    )

    Parameters

    stream
    Поток, в котором должно быть сохранено изображение.
    encoder
    Кодировщик для сохранения изображения.
    savingProgress
    Делегат процесса сохранения изображения. Может быть установлен в null (Nothing в Visual Basic).
    Исключения
    ИсключениеОписание
    Выбрасывается, если stream или encoder равны null.
    Выбрасывается, если при сохранении изображения произошла ошибка.
    Выбрасывается, если изображение удалено.
    Ремарки

    Поддерживаемые форматы изображений: BMP, GIF, JBIG2, JPEG, PCX, PDF, PNG, TIFF.

    Подходящий кодировщик выбирается автоматически из расширения имени файла, исключение возникает, если кодировщик не найден для расширения файла, указанного в filename.

    Если изображение сохраняется в новый файл (stream != SourceInfo.Stream), этот метод:

    • сохраняет изображение в новый файл BMP/GIF/JBIG2/JPEG/PCX/PDF/PNG/TIFF, если MultipageEncoderBase.CreateNewFile = true; файл, указанный filename, заменяется, если он существует
    • сохраняет изображение в новый файл JBIG2/PDF/TIFF, если MultipageEncoderBase.CreateNewFile = false и файл, указанный filename, не существует
    • добавляет изображение в новый файл JBIG2/PDF/TIFF, если MultipageEncoderBase.CreateNewFile = false и файл, указанный filename, существует

    Если изображение сохраняется в исходный файл (stream == SourceInfo.Stream), этот метод:
    • сохраняет изображение в исходный файл BMP/GIF/JBIG2/JPEG/PCX/PDF/PNG/TIFF, если изображение изменено (IsChanged = true) и исходный файл содержит только одно изображение
    • вызывает исключение, если изображение сохранено в исходном файле BMP/GIF/JBIG2/JPEG/PCX/PDF/PNG/TIFF и изображение не изменено (IsChanged = false)
    • добавляет изображение в исходный файл JBIG2/PDF/TIFF, если MultipageEncoderBase.CreateNewFile = false, файл, указанный filename, существует

    Пример

    Вот C#/VB.NET код, который демонстрирует, как загрузить изображение с диска и сохранить его в памяти как поток JPEG.

    
    ' load image from file
    Using image As New Vintasoft.Imaging.VintasoftImage("c:\original-image.tif")
        Dim memory As New System.IO.MemoryStream()
        ' create JPEG encoder
        Dim encoder As New Vintasoft.Imaging.Codecs.Encoders.JpegEncoder(New Vintasoft.Imaging.Codecs.Encoders.JpegEncoderSettings(10))
        ' save annotations with image
        encoder.AnnotationsFormat = Vintasoft.Imaging.AnnotationsFormat.VintasoftBinary
        ' save image to file
        image.Save(memory, encoder)
    End Using
    
    
    
    // load image from file
    using (Vintasoft.Imaging.VintasoftImage image =
        new Vintasoft.Imaging.VintasoftImage(@"c:\original-image.tif"))
    {
        System.IO.MemoryStream memory = new System.IO.MemoryStream();
        // create JPEG encoder
        Vintasoft.Imaging.Codecs.Encoders.JpegEncoder encoder =
            new Vintasoft.Imaging.Codecs.Encoders.JpegEncoder(
                new Vintasoft.Imaging.Codecs.Encoders.JpegEncoderSettings(10));
        // save annotations with image
        encoder.AnnotationsFormat = Vintasoft.Imaging.AnnotationsFormat.VintasoftBinary;
        // save image to file
        image.Save(memory, encoder);
    }
    
    

    Требования

    Целевые платформы: .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

    Смотрите также